Contexto global.StrEncontrarPorExpresionRegular

Contexto global

StrEncontrarPorExpresionRegular

Disponible desde la versión 8.3.23.

Sintaxis:

StrEncontrarPorExpresionRegular(<Cadena>, <ExpresionRegular>, <DireccionBusqueda>, <IndiceInicio>, <NumeroEntrada>, <IgnorarMayusculas>, <BusquedaMultilinea>)

Parámetros:

<Cadena> (obligatorio)

Tipo: Cadena.
Cadena de origen.

<ExpresionRegular> (obligatorio)

Tipo: Cadena.
Expresión regular utilizada para la búsqueda.

<DireccionBusqueda> (opcional)

Tipo: DireccionBusqueda.
Especifica una dirección para buscar una expresión regular en una cadena.
Valor predeterminado: DesdeInicio.

<IndiceInicio> (opcional)

Tipo: Número.
Indica una posición en una cadena para comenzar la búsqueda.

  • El valor es igual a 1 de forma predeterminada si no se especifica el parámetro y el parámetro DireccionBusqueda contiene el valor DesdeInicio.
  • El valor es igual a la longitud de la cadena de forma predeterminada si no se especifica el parámetro y el parámetro DireccionBusqueda contiene el valor DesdeFin.

Se permiten valores del 1 al número de caracteres en la cadena donde se realiza la búsqueda. Si se especifica un valor fuera de este rango, se generará el error “Valores de parámetro incorrectos”.
Valor predeterminado: 1.

<NumeroEntrada> (opcional)

Tipo: Número.
Especifica el número de ocurrencia de una cadena que se debe encontrar en la cadena de origen.
Valor predeterminado: 1.

<IgnorarMayusculas> (opcional)

Tipo: Booleano.
Verdadero – no distingue mayúsculas y minúsculas, Falso – distingue mayúsculas y minúsculas.

<BusquedaMultilinea> (opcional)

Tipo: Booleano.
Verdadero. Se realiza una búsqueda multilinea. En una plantilla de expresión regular, el carácter “^” coincide con el inicio de cada línea del valor del parámetro <Cadena>, y el carácter “$” coincide con el final de cada línea.

Falso. En una plantilla de expresión regular, el carácter “^” coincide con el inicio del valor del parámetro <Cadena>, y el carácter “$” coincide con el final del texto.
Valor predeterminado: Falso.

Valor devuelto:

Tipo: ResultadoDeBusquedaPorExpresionRegular.

Descripción:

Encuentra la primera ocurrencia de una expresión regular en la cadena de origen.

Disponibilidad:

Servidor, cliente grueso, conexión externa, aplicación móvil (servidor).

Ejemplo:

Cadena = “Las rosas son #ff0000”;
ExpresionRegular = “#([af09]{6})“;

ResultadoBusqueda = StrEncontrarPorExpresionRegular(Cadena, ExpresionRegular);
Si ResultadoBusqueda.PosicionInicio <> 0 Entonces
    ResultadoCadena = Medio(Cadena,
        ResultadoBusqueda.PosicionInicio, ResultadoBusqueda.Longitud);
FinSi;

Disponible desde:

Disponible desde la versión 8.3.23.

Descripción cambiada en la versión 8.3.24.